<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkListStore</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="GTK+ 3 参考手册">
<link rel="up" href="TreeWidgetObjects.html" title="树、列表和图标网格构件">
<link rel="prev" href="gtk3-GtkCellRendererSpinner.html" title="GtkCellRendererSpinner">
<link rel="next" href="gtk3-GtkTreeStore.html" title="GtkTreeStore">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="gtk3-GtkCellRendererSpinner.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="TreeWidgetObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ 3 参考手册</th>
<td><a accesskey="n" href="gtk3-GtkTreeStore.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#gtk3-GtkListStore.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#gtk3-GtkListStore.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="gtk3-GtkListStore"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="gtk3-GtkListStore.top_of_page"></a>GtkListStore</span></h2>
<p>GtkListStore</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="gtk3-GtkListStore.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;gtk/gtk.h&gt;

struct              <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore">GtkListStore</a>;
<a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="returnvalue">GtkListStore</span></a> *      <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-new" title="gtk_list_store_new ()">gtk_list_store_new</a>                  (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_columns</code></em>,
                                                         <em class="parameter"><code>...</code></em>);
<a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="returnvalue">GtkListStore</span></a> *      <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-newv" title="gtk_list_store_newv ()">gtk_list_store_newv</a>                 (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_columns</code></em>,
                                                         <em class="parameter"><code><a href="../gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> *types</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set-column-types" title="gtk_list_store_set_column_types ()">gtk_list_store_set_column_types</a>     (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_columns</code></em>,
                                                         <em class="parameter"><code><a href="../gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> *types</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set" title="gtk_list_store_set ()">gtk_list_store_set</a>                  (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code>...</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set-valist" title="gtk_list_store_set_valist ()">gtk_list_store_set_valist</a>           (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set-value" title="gtk_list_store_set_value ()">gtk_list_store_set_value</a>            (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> column</code></em>,
                                                         <em class="parameter"><code><a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set-valuesv" title="gtk_list_store_set_valuesv ()">gtk_list_store_set_valuesv</a>          (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *columns</code></em>,
                                                         <em class="parameter"><code><a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *values</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_values</code></em>);
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-remove" title="gtk_list_store_remove ()">gtk_list_store_remove</a>               (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-insert" title="gtk_list_store_insert ()">gtk_list_store_insert</a>               (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-insert-before" title="gtk_list_store_insert_before ()">gtk_list_store_insert_before</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *sibling</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-insert-after" title="gtk_list_store_insert_after ()">gtk_list_store_insert_after</a>         (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *sibling</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-insert-with-values" title="gtk_list_store_insert_with_values ()">gtk_list_store_insert_with_values</a>   (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
                                                         <em class="parameter"><code>...</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-insert-with-valuesv" title="gtk_list_store_insert_with_valuesv ()">gtk_list_store_insert_with_valuesv</a>  (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *columns</code></em>,
                                                         <em class="parameter"><code><a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *values</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_values</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-prepend" title="gtk_list_store_prepend ()">gtk_list_store_prepend</a>              (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-append" title="gtk_list_store_append ()">gtk_list_store_append</a>               (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-clear" title="gtk_list_store_clear ()">gtk_list_store_clear</a>                (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>);
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-iter-is-valid" title="gtk_list_store_iter_is_valid ()">gtk_list_store_iter_is_valid</a>        (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-reorder" title="gtk_list_store_reorder ()">gtk_list_store_reorder</a>              (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *store</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *new_order</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-swap" title="gtk_list_store_swap ()">gtk_list_store_swap</a>                 (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *a</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *b</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-move-before" title="gtk_list_store_move_before ()">gtk_list_store_move_before</a>          (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *position</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-move-after" title="gtk_list_store_move_after ()">gtk_list_store_move_after</a>           (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *position</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="gtk3-GtkListStore.description"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1">
<a name="gtk3-GtkListStore.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="GtkListStore"></a><h3>struct GtkListStore</h3>
<pre class="programlisting">struct GtkListStore {
  GObject parent;
};
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-new"></a><h3>gtk_list_store_new ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="returnvalue">GtkListStore</span></a> *      gtk_list_store_new                  (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_columns</code></em>,
                                                         <em class="parameter"><code>...</code></em>);</pre>
<p>
Creates a new list store as with <em class="parameter"><code>n_columns</code></em> columns each of the types passed
in.  Note that only types derived from standard GObject fundamental types 
are supported. 
</p>
<p>
As an example, <code class="literal">gtk_tree_store_new (3, G_TYPE_INT, G_TYPE_STRING,
GDK_TYPE_PIXBUF);</code> will create a new <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> with three columns, of type
int, string and <a href="../gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> respectively.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_columns</code></em> :</span></p></td>
<td>number of columns in the list store</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a new <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-newv"></a><h3>gtk_list_store_newv ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="returnvalue">GtkListStore</span></a> *      gtk_list_store_newv                 (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_columns</code></em>,
                                                         <em class="parameter"><code><a href="../gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> *types</code></em>);</pre>
<p>
Non-vararg creation function.  Used primarily by language bindings.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_columns</code></em> :</span></p></td>
<td>number of columns in the list store</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>types</code></em> :</span></p></td>
<td>an array of <a href="../gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> types for the columns, from first to last. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_columns]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a new <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>
Rename to: gtk_list_store_new. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-set-column-types"></a><h3>gtk_list_store_set_column_types ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_set_column_types     (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_columns</code></em>,
                                                         <em class="parameter"><code><a href="../gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> *types</code></em>);</pre>
<p>
This function is meant primarily for <a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObjects</span></a> that inherit from <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>,
and should only be used when constructing a new <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>.  It will not
function after a row has been added, or a method on the <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeModel" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>
interface is called.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_columns</code></em> :</span></p></td>
<td>Number of columns for the list store</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>types</code></em> :</span></p></td>
<td>An array length n of <a href="../gobject/gobject-Type-Information.html#GType"><span class="type">GTypes</span></a>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_columns]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-set"></a><h3>gtk_list_store_set ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_set                  (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code>...</code></em>);</pre>
<p>
Sets the value of one or more cells in the row referenced by <em class="parameter"><code>iter</code></em>.
The variable argument list should contain integer column numbers,
each column number followed by the value to be set.
The list is terminated by a -1. For example, to set column 0 with type
<a href="../gobject/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a> to "Foo", you would write <code class="literal">gtk_list_store_set (store, iter,
0, "Foo", -1)</code>.
</p>
<p>
The value will be referenced by the store if it is a <a href="../gobject/gobject-Type-Information.html#G-TYPE-OBJECT:CAPS"><code class="literal">G_TYPE_OBJECT</code></a>, and it
will be copied if it is a <a href="../gobject/gobject-Type-Information.html#G-TYPE-STRING:CAPS"><code class="literal">G_TYPE_STRING</code></a> or <a href="../gobject/gobject-Type-Information.html#G-TYPE-BOXED:CAPS"><code class="literal">G_TYPE_BOXED</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>row iterator</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-set-valist"></a><h3>gtk_list_store_set_valist ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_set_valist           (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
<p>
See <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set" title="gtk_list_store_set ()"><code class="function">gtk_list_store_set()</code></a>; this version takes a va_list for use by language
bindings.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>A valid <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> for the row being modified</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>var_args</code></em> :</span></p></td>
<td>va_list of column/value pairs</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-set-value"></a><h3>gtk_list_store_set_value ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_set_value            (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> column</code></em>,
                                                         <em class="parameter"><code><a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
<p>
Sets the data in the cell specified by <em class="parameter"><code>iter</code></em> and <em class="parameter"><code>column</code></em>.
The type of <em class="parameter"><code>value</code></em> must be convertible to the type of the
column.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>A valid <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> for the row being modified</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>column</code></em> :</span></p></td>
<td>column number to modify</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td>new value for the cell</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-set-valuesv"></a><h3>gtk_list_store_set_valuesv ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_set_valuesv          (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *columns</code></em>,
                                                         <em class="parameter"><code><a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *values</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_values</code></em>);</pre>
<p>
A variant of <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set-valist" title="gtk_list_store_set_valist ()"><code class="function">gtk_list_store_set_valist()</code></a> which
takes the columns and values as two arrays, instead of
varargs. This function is mainly intended for 
language-bindings and in case the number of columns to
change is not known until run-time.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>A valid <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> for the row being modified</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>columns</code></em> :</span></p></td>
<td>an array of column numbers. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_values]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>values</code></em> :</span></p></td>
<td>an array of GValues. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_values]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_values</code></em> :</span></p></td>
<td>the length of the <em class="parameter"><code>columns</code></em> and <em class="parameter"><code>values</code></em> arrays</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-remove"></a><h3>gtk_list_store_remove ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_list_store_remove               (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);</pre>
<p>
Removes the given row from the list store.  After being removed, 
<em class="parameter"><code>iter</code></em> is set to be the next valid row, or invalidated if it pointed 
to the last row in <em class="parameter"><code>list_store</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>A valid <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>iter</code></em> is valid, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if not.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-insert"></a><h3>gtk_list_store_insert ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_insert               (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
<p>
Creates a new row at <em class="parameter"><code>position</code></em>.  <em class="parameter"><code>iter</code></em> will be changed to point to this new
row.  If <em class="parameter"><code>position</code></em> is larger than the number of rows on the list, then the
new row will be appended to the list. The row will be empty after this
function is called.  To fill in values, you need to call 
<a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set" title="gtk_list_store_set ()"><code class="function">gtk_list_store_set()</code></a> or <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set-value" title="gtk_list_store_set_value ()"><code class="function">gtk_list_store_set_value()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>An unset <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set to the new row. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
<td>position to insert the new row</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-insert-before"></a><h3>gtk_list_store_insert_before ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_insert_before        (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *sibling</code></em>);</pre>
<p>
Inserts a new row before <em class="parameter"><code>sibling</code></em>. If <em class="parameter"><code>sibling</code></em> is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the row will 
be appended to the end of the list. <em class="parameter"><code>iter</code></em> will be changed to point to this 
new row. The row will be empty after this function is called. To fill in 
values, you need to call <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set" title="gtk_list_store_set ()"><code class="function">gtk_list_store_set()</code></a> or <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set-value" title="gtk_list_store_set_value ()"><code class="function">gtk_list_store_set_value()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>An unset <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set to the new row. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>sibling</code></em> :</span></p></td>
<td>A valid <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-insert-after"></a><h3>gtk_list_store_insert_after ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_insert_after         (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *sibling</code></em>);</pre>
<p>
Inserts a new row after <em class="parameter"><code>sibling</code></em>. If <em class="parameter"><code>sibling</code></em> is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the row will be
prepended to the beginning of the list. <em class="parameter"><code>iter</code></em> will be changed to point to
this new row. The row will be empty after this function is called. To fill
in values, you need to call <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set" title="gtk_list_store_set ()"><code class="function">gtk_list_store_set()</code></a> or <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set-value" title="gtk_list_store_set_value ()"><code class="function">gtk_list_store_set_value()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>An unset <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set to the new row. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>sibling</code></em> :</span></p></td>
<td>A valid <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-insert-with-values"></a><h3>gtk_list_store_insert_with_values ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_insert_with_values   (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
                                                         <em class="parameter"><code>...</code></em>);</pre>
<p>
Creates a new row at <em class="parameter"><code>position</code></em>.  <em class="parameter"><code>iter</code></em> will be changed to point to this new
row.  If <em class="parameter"><code>position</code></em> is larger than the number of rows on the list, then the
new row will be appended to the list. The row will be filled with the 
values given to this function. 
</p>
<p>
Calling
<code class="literal">gtk_list_store_insert_with_values(list_store, iter, position...)</code> 
has the same effect as calling 
</p>
<div class="informalexample"><pre class="programlisting">
gtk_list_store_insert (list_store, iter, position);
gtk_list_store_set (list_store, iter, ...);
</pre></div>
<p>
with the difference that the former will only emit a row_inserted signal,
while the latter will emit row_inserted, row_changed and, if the list store
is sorted, rows_reordered. Since emitting the rows_reordered signal
repeatedly can affect the performance of the program, 
<a class="link" href="gtk3-GtkListStore.html#gtk-list-store-insert-with-values" title="gtk_list_store_insert_with_values ()"><code class="function">gtk_list_store_insert_with_values()</code></a> should generally be preferred when
inserting rows in a sorted list store.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>An unset <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set to the new row, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
<td>position to insert the new row</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-insert-with-valuesv"></a><h3>gtk_list_store_insert_with_valuesv ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_insert_with_valuesv  (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *columns</code></em>,
                                                         <em class="parameter"><code><a href="../gobject/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *values</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_values</code></em>);</pre>
<p>
A variant of <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-insert-with-values" title="gtk_list_store_insert_with_values ()"><code class="function">gtk_list_store_insert_with_values()</code></a> which
takes the columns and values as two arrays, instead of
varargs. This function is mainly intended for 
language-bindings.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>An unset <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set to the new row, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
<td>position to insert the new row</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>columns</code></em> :</span></p></td>
<td>an array of column numbers. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_values]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>values</code></em> :</span></p></td>
<td>an array of GValues. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_values]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_values</code></em> :</span></p></td>
<td>the length of the <em class="parameter"><code>columns</code></em> and <em class="parameter"><code>values</code></em> arrays</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-prepend"></a><h3>gtk_list_store_prepend ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_prepend              (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);</pre>
<p>
Prepends a new row to <em class="parameter"><code>list_store</code></em>. <em class="parameter"><code>iter</code></em> will be changed to point to this new
row. The row will be empty after this function is called. To fill in
values, you need to call <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set" title="gtk_list_store_set ()"><code class="function">gtk_list_store_set()</code></a> or <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set-value" title="gtk_list_store_set_value ()"><code class="function">gtk_list_store_set_value()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>An unset <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set to the prepend row. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-append"></a><h3>gtk_list_store_append ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_append               (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);</pre>
<p>
Appends a new row to <em class="parameter"><code>list_store</code></em>.  <em class="parameter"><code>iter</code></em> will be changed to point to this new
row.  The row will be empty after this function is called.  To fill in
values, you need to call <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set" title="gtk_list_store_set ()"><code class="function">gtk_list_store_set()</code></a> or <a class="link" href="gtk3-GtkListStore.html#gtk-list-store-set-value" title="gtk_list_store_set_value ()"><code class="function">gtk_list_store_set_value()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>An unset <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> to set to the appended row. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-clear"></a><h3>gtk_list_store_clear ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_clear                (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>);</pre>
<p>
Removes all rows from the list store.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em> :</span></p></td>
<td>a <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>.</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-iter-is-valid"></a><h3>gtk_list_store_iter_is_valid ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_list_store_iter_is_valid        (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *list_store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);</pre>
<p>
</p>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>This function is slow. Only use it for debugging and/or testing
purposes.</div>
<p>
</p>
<p>
Checks if the given iter is a valid iter for this <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list_store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the iter is valid, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the iter is invalid.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-reorder"></a><h3>gtk_list_store_reorder ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_reorder              (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *store</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *new_order</code></em>);</pre>
<p>
Reorders <em class="parameter"><code>store</code></em> to follow the order indicated by <em class="parameter"><code>new_order</code></em>. Note that
this function only works with unsorted stores.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>new_order</code></em> :</span></p></td>
<td>an array of integers mapping the new position of each child
to its old position before the re-ordering,
i.e. <em class="parameter"><code>new_order</code></em><code class="literal">[newpos] = oldpos</code>. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-swap"></a><h3>gtk_list_store_swap ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_swap                 (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *a</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *b</code></em>);</pre>
<p>
Swaps <em class="parameter"><code>a</code></em> and <em class="parameter"><code>b</code></em> in <em class="parameter"><code>store</code></em>. Note that this function only works with
unsorted stores.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>a</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>b</code></em> :</span></p></td>
<td>Another <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-move-before"></a><h3>gtk_list_store_move_before ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_move_before          (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *position</code></em>);</pre>
<p>
Moves <em class="parameter"><code>iter</code></em> in <em class="parameter"><code>store</code></em> to the position before <em class="parameter"><code>position</code></em>. Note that this
function only works with unsorted stores. If <em class="parameter"><code>position</code></em> is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>iter</code></em>
will be moved to the end of the list.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-list-store-move-after"></a><h3>gtk_list_store_move_after ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_list_store_move_after           (<em class="parameter"><code><a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a> *store</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> *position</code></em>);</pre>
<p>
Moves <em class="parameter"><code>iter</code></em> in <em class="parameter"><code>store</code></em> to the position after <em class="parameter"><code>position</code></em>. Note that this
function only works with unsorted stores. If <em class="parameter"><code>position</code></em> is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>iter</code></em>
will be moved to the start of the list.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>store</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkListStore.html#GtkListStore" title="struct GtkListStore"><span class="type">GtkListStore</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkTreeModel.html#GtkTreeIter" title="struct GtkTreeIter"><span class="type">GtkTreeIter</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.18</div>
</body>
</html>